Changes the contents of a string referenced by a string handle, replacing the previous contents by copying the specified string.

void SetString (
    StringHandle theString, 
    ConstStr255Param strNew
);

Parameter descriptions

theString

A Pascal string.

strNew

A handle to the string in memory whose contents you are replacing. If the new string (theString) is larger than the string originally referenced by strNew, SetString automatically resizes the handle and copies in the contents of the specified string.

SPECIAL CONSIDERATIONS

SetString may move memory; your application should not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)